package com.ruoyi.module.service;

import com.ruoyi.common.core.domain.AjaxResult;

/**
 * 词典单词导入Service接口
 * 
 * @author ruoyi
 */
public interface IDictWordImportService 
{
    /**
     * 从JSON文件导入单词到数据库
     * 
     * @param bookId 词典ID
     * @param jsonFilePath JSON文件路径（可以是本地文件路径或URL）
     * @param username 操作用户
     * @return 导入结果
     */
    AjaxResult importWordsFromJson(String bookId, String jsonFilePath, String username);

    /**
     * 从JSON内容字符串导入单词到数据库
     * 
     * @param bookId 词典ID
     * @param jsonContent JSON内容字符串
     * @param username 操作用户
     * @return 导入结果
     */
    AjaxResult importWordsFromJsonContent(String bookId, String jsonContent, String username);

    /**
     * 批量导入目录下所有词典的单词
     * 
     * @param dictPath 词典文件目录路径
     * @param username 操作用户
     * @return 导入结果
     */
    AjaxResult batchImportAllDictWords(String dictPath, String username);

    /**
     * 清空词典的所有单词
     * 
     * @param bookId 词典ID
     * @return 删除数量
     */
    int deleteWordsByBookId(String bookId);
}

